Skip to main content
This forum is closed to new posts and responses. Individual names altered for privacy purposes. The information contained in this website is provided for informational purposes only and should not be construed as a forum for customer support requests. Any customer support requests should be directed to the official HCL customer support channels below:

HCL Software Customer Support Portal for U.S. Federal Government clients
HCL Software Customer Support Portal

Notes/Domino 6 and 7 Forum

Notes/Domino 6 and 7 Forum


  

PreviousPrevious NextNext

Comprehensive Tech Note on this
~Sean Minkivitch 15.Jan.04 04:44 PM a Web browser
Domino Administrator 6.0 Windows NT


Found this on support site--putting it in here in case anyone needs it:

http://www-1.ibm.com/support/docview.wss?rs=475&context=SSKTWP&q1=6+administrator+R5+server&uid=swg21086439&loc=en_US&cs=utf-8&lang=en+en


And just in case the link breaks someday:


Software > Groupware - Productivity and Lotus > Lotus Support Services >
Design Elements Missing from Domino Directory and "B-tree Structure Is Invalid" After Opening Domino Directory

Technote Reference #:
1086439

Problem
You open the Domino Directory on a Domino R5.x Server with a Notes 6.x Client. and see the following:

* The database title in the upper left corner of the window with a listing of people in the right hand side of the window
* The left hand Navigation window is empty

If (while still using the Notes 6.x Client) you attempt to open a Person document, the following error occurs:

* "Cannot locate form: Person"

After this initial problem occurs, if a user with Manager access in the Access Control List (ACL) of the Domino Directory opens the Directory using a Domino R5 Designer client, and attempts to create and save any new design element the following occurs:

* Within Designer, the error "B-tree structure is invalid" displays.
* At the server console the following displays: "err_invalid_btree ERROR: Btree context signature is NULL"

Subsequently, if a user attempts to open the Domino Directory with either client version, regardless of ACL access rights, the above two errors occur and prevent the Domino Directory from being opened.

In the log file or console of the R5.x server, any one of the following errors can appear:

* B-tree structure is invalid
* Unable to open view <view name> : B-tree structure is invalid
* Error updating views in Name & Address book(s): B-tree structure is invalid
* Index update process shutdown: B-tree structure is invalid
* ERROR: Btree context signature is NULL
* err_invalid_btree ERROR: Btree context signature is NULL


Cause
These various problems may occur after a Notes 6.x Client or Domino 6.x Administrator client accesses the Domino Directory on a Domino R5 Server. It does not happen every time a Notes 6.x Client or Domino 6.x Administration client opens the Domino Directory, but in some environments the problem is easily reproducible.
The problem will occur when the Domino Directory design collection is discarded and not rebuilt. All of the following conditions are required for the problem to occur:

* The Domino Server has to be R5.x
* The Notes Client/Administration Client has to be 6.x
* The Domino Directory Design Collection version must be less than or equal to version "E"
* The Client access level to Names.nsf is Editor or lower (for example, Author or Reader)
* The Notes Client/Administration Client 6.x must open Names.nsf (Domino Directory)

When these specific conditions all occur, the R5 server code does not check to see if the Notes 6.x Client user has appropriate access rights in the ACL of Names.nsf to rebuild the design collection, and allows the design collection to be deleted even though the client access level does not permit the design collection to be rebuilt after it has been discarded.

As designed, when Names.nsf is opened by the Domino 5.x Server for the Notes 6.x Client with Manager or Designer access, the design collection is opened and a check is made to determine whether the design collection version is valid. If the design collection version is not valid, the design collection is emptied and then reinitialized. This is the correct functionality and ensures that the design collection is in a good state.

In the case where a Notes 6.x Client with Editor access or lower opens Names.nsf, again a check is made to ensure that the design collection version is valid**, and if it is not valid the code makes a call to the R5 server to delete and rebuild it. However, because the client has only Editor access, the design collection can not be rebuilt as in the case where the client has Manager or Designer access. The R5.x server code does not verify if the user has appropriate access rights to rebuild the design collection before allowing the design collection to be deleted and is then unable to rebuild it. This deleted design collection is the reason the design elements are missing when the Domino directory is opened.

** An invalid design collection is any design collection less than or equal to the version specified by the current client.

Notes/Domino 5.x uses a design collection version E
Notes/Domino 6.0 uses a design collection version G
Notes/Domino 6.0.1 uses a design collection version H

Example of invalid design collection: When a Notes 6.0 Client accesses a collection with a value less than G it will attempt to rebuild the design collection. As described above, the problem arises when the Notes 6.x Client with Editor access or below opens the Domino Directory where the design collection is version E (or earlier).


Solution
The problem does not replicate to other servers since the design collection is built on the fly for each replica and does not replicate. To correct the problem if it has already occurred and to prevent future occurrences:
1. Bring down the Domino server.
2. Open the Domino Directory locally with a Notes 6.x Client who has Manager access, mapping a network drive as necessary to have local access.
3. Restart the Domino server.
4. For any Notes 6.x Clients that have experienced the problem and can no longer view the directory, remove the Domino Directory icon from the Workspace and bookmarks, and then re-add it.

If you have not experienced the problem, there are two ways to prevent the problem:

1. Upgrade all Notes 6.0 and 6.0.1 Clients who have Editor or lower access to the Domino Directory to Notes Client 6.0.1 Critical Fix 1. The Notes Client 6.0.1 CF1 fix checks the access rights of the client. If the client doesn't have the correct access rights to rebuild the collection, then the call to the R5 server to delete the collection won't be allowed.

Excerpt from the Lotus Notes and Domino Release 6.0.1 CF1 fix list (available at http://www.lotus.com/ldd):

Client
o SPR# SSHE592PAE - Fixed an issue where R5 names.nsf databases were experiencing b-tree corruption when opened with a Notes 6 client.


2. As a one time procedure to upgrade the design collection of the Domino Directory, with the server still running, open the Domino Directory with a Notes 6.x Client who has Manager access to the directory. This will upgrade the design collection version and prevent the condition which causes the design collection to be deleted




R6 Admin Client on R5 Server (~Sigmund Xanfoo... 6.Feb.03)
. . I use the R6 Admin client against R... (~Dan Elhipister... 6.Feb.03)
. . RE: R6 Admin Client on R5 Server (~Naomi Deskrote... 6.Feb.03)
. . . . RE: R6 Admin Client on R5 Server (~Lisa Asanusono... 7.Feb.03)
. . Comprehensive Tech Note on this (~Sean Minkivitc... 15.Jan.04)


Document Options






  Document options
Print this pagePrint this page

Search this forum

Forum views and search


  Forum views and search
Date (threaded)
Date (flat)
With excerpt
Category
Platform
Release
Advanced search

Member Tools


RSS Feeds

 RSS feedsRSS
All forum posts RSS
All main topics RSS